This project showcases a real-time collaborative AR experience where two users perform a high-five gesture. The system synchronizes hand positions across devices and detects when the hands are close enough to trigger the high-five. This interaction activates shared visual effects and displays the users' names. It demonstrates the potential of Connected Lenses for creating engaging social connections in AR.
NOTE: This project will only work for the Spectacles platform.
Designing Lenses for Spectacles offers all-new possibilities to rethink user interaction with digital spaces and the physical world. Get started using our Design Guidelines
- Lens Studio: v5.15.1+
- Spectacles OS Version: v5.64+
- Spectacles App iOS: v0.64+
- Spectacles App Android: v0.64+
To update your Spectacles device and mobile app, please refer to this guide.
You can download the latest version of Lens Studio from here.
The camera feature requires you to use Experimental APIs. Please see Experimental APIs for more details here.
Extended Permissions mode on device must be enabled for enabling some of the Spectacles APIs. Please see Extended Permissions for more details here.
To obtain the project folder, clone the repository.
IMPORTANT: This project uses Git Large Files Support (LFS). Downloading a zip file using the green button on GitHub will not work. You must clone the project with a version of git that has LFS. You can download Git LFS here.
The project should be pre-configured to get you started without any additional steps. However, if you encounter issues in the Logger Panel, please ensure your Lens Studio environment is set up for Spectacles.
EntryPointMain.ts - This script serves as the entry point for the Lens logic, initializing and managing the execution of other scripts within the project.
- Open the Lens in Lens Studio and create two Interactive Previews using the Interactive Preview Panel
- Click the Multiplayer button for both previews. They will connect to the same session and map surroundings automatically.
- Simulate a high-five gesture by interacting within the connected session:
- Select the Webcam mode and use your left hand to mimic the high-five gesture between the two previews.
- Verify that the high-five gesture triggers the shared animation between the two users.
- Confirm that both usernames are displayed correctly in each preview.
- Connect two pairs of Spectacles to the same session following the Playing Connected Lenses Guide.
- Test functionality:
- Perform a high-five gesture using the right hands of the two users. Confirm that the shared animation appears between their hands.
- Verify that both usernames are displayed correctly for each user and that the effect functions seamlessly.
If you have any questions or need assistance, please don't hesitate to reach out. Our community is here to help, and you can connect with us and ask for support here. We look forward to hearing from you and are excited to assist you on your journey!
Feel free to provide improvements or suggestions or directly contributing via merge request. By sharing insights, you help everyone else build better Lenses.
Built with 👻 by the Spectacles team